home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archivers / DMSui / English.doc < prev    next >
Text File  |  1996-09-26  |  18KB  |  438 lines
  1.  
  2.                DMS userinterface v2.0
  3.  
  4.              (c) 1991-92 Mathias 'Ice' Axelsson
  5.  
  6.                   Released 920803
  7.  
  8.  
  9.    About this program
  10.  
  11.     What you need to run this program is, for the first, an Amiga
  12.     with 512k of RAM and a diskdrive. Furthermore you need the DMS
  13.     package (Generic version) which can be found at any PD library.
  14.     Both v1.03 and the new v1.11 is supported by this program and
  15.     you _MUST_ have the generic (CLI) version of the DMS program.
  16.     You may also need the UnWarp program which is also to be found
  17.     in any PD library (but it's not necessary to run DMSui).
  18.     The DMSui program is just a userinterface to make the whole
  19.     thing a lot easier, using requesters to get files and so on.
  20.     DMS userinterface is from this point refered to as DMSui.
  21.  
  22.    Getting started
  23.  
  24.     To install this program on your HD just run the script 'Install'
  25.     using either 'execute Install' or just doubleclicking the icon
  26.     from the workbench.
  27.     This will copy the necessary files to your HD paths, making it
  28.     easier for you to just run the DMSui program.
  29.  
  30.     After that you have to copy the DMSui program to your HD. Put it
  31.     in the C: directory or anywhere you like in your path.
  32.     
  33.     To install DMSui on your Workbench just drag its icon to the
  34.     desired drawer.
  35.     
  36.     At last you need to install the DMS program. Put it in the C:
  37.     directory or in any other directory (It's just to specify that
  38.     directory in the preferences in DMSui). You may also need to
  39.     install the UnWarp program. Put that file in the same directory
  40.     as the DMS program.
  41.     
  42.     Now the installation is complete and you can run DMSui.
  43.     
  44.    Different fileformats
  45.     
  46.     In version 2 of the DMSui program I have made a lot of changes.
  47.     The mayor change from v1.4 is that I now have written an own
  48.     filerequester which can handle files from different directorys
  49.     (This is explained fully later in this documentation).
  50.     There are three types of files supported by DMSui. These are
  51.     .paths, .files and .clist. A quick description of these is:
  52.     
  53.     .paths means a textfile containing the different directorys
  54.            to scan for files.
  55.     
  56.     .files means a file containing a list of the scanned files and
  57.            which directory they belong to.
  58.     
  59.     .clist means a textfile containing names of the files you want
  60.            to be selected in the filerequester.
  61.  
  62.    Disclaimer
  63.     
  64.     DMS userinterface v2.0 may me freely distributed by any PD library
  65.     as long as no charge is taken for the program. DMSui is a SHAREWARE
  66.     product which means that if you use it a lot you should register
  67.     and pay the shareware fee which at the time is 100 SKR for people
  68.     living in the Nordic countries and 20 US$ for Europees and other
  69.     countries. The registration gives you one free upgrade of the
  70.     program (when I have finished it). I have spent a lot of time
  71.     programming and improving this program so please support my
  72.     program and pay the shareware fee. PD libraries are free to contact
  73.     me for distribution.
  74.     
  75.    Documentation
  76.     
  77.     First I will explain the fileformats fully, because these are the
  78.     mayor improvement in this upgrade. In DMSui v2.0 you can use my
  79.     own filerequester which makes it possible to see all files you have
  80.     in the different directorys in one filerequester. This is useful
  81.     for people running BBS:s and people with big HD:s. You can specify
  82.     all the directorys you have files in and let DMSui scan the files
  83.     for you and you don't need to search for which directory you have
  84.     put a specified file in.
  85.     
  86.     Paths file
  87.        This file is a textfile which contains the different directorys
  88.        to be scanned for files. It can look as follows:
  89.        
  90.        DH0:BBS/Upload
  91.        DH2:NewUploads/
  92.        DH1:Board1/NewUploads/TempStorage
  93.        
  94.        As you can see it doesn't matter if you put a slash at the end
  95.        of the path because DMSui can handle both. If you, for any
  96.        reason, would like to skip a directory you can put a semicolon
  97.        in the beginning of the row like this:
  98.        
  99.        ;DH2:NewUploads/
  100.        
  101.        This makes the DMSui skip this directory when it scans for files.
  102.        If you make one empty row all the rest directorys will be skipped.
  103.  
  104.     FList file
  105.        This is a file which contains all the files that have been found
  106.        during the scan. It also contains data on which path it was found
  107.        in and the filesize.
  108.     
  109.     CList file
  110.        This file is much like the paths file except that this file
  111.        contains a list of filenames to be marked in the filerequester
  112.        (Only in the filerequester I have written). This is useful if
  113.        you would like to unpack a lot of disks and don't want to sit
  114.        and select all the files by hand.
  115.     
  116.     Now I will explain all the functions in DMSui.
  117.     
  118.     Filename
  119.        Here you can type the name of the file you want to process. You
  120.        must specify the path as well or DMSui will assume that the file
  121.        will be in the current directory. You can choose the filename by
  122.        either clicking the stringgadget and type the names by hand or
  123.        you can click on the GET gadget to the right of the stringgadget
  124.        to get a filerequester to choose the filenames for you. If you
  125.        choose to use the filerequester you can multiselect up to four
  126.        files that you want to choose by holding down the SHIFT key and
  127.        licking on the filenames. The filenames are used as follows:
  128.        
  129.        Read:   If you specify more than one filename the DMSui program
  130.               will split up the disk into two parts, the first with
  131.               starttrack to 39 and the second with track 40 to end-
  132.               track. Even if you have selected more than two names
  133.               only the two first names will be used. Also, if you have
  134.               selected starttrack to a greater value than 39, or end-
  135.               track to a lesser value than 40, the program will only
  136.               use the first name.
  137.        
  138.        Write:  When you use write all the four filenames will be used.       
  139.               The program will unpack all the four files to one disk
  140.               (except when you use multiple disk mode, which is
  141.               explained later on). Be carful when you unpack four
  142.               files to one disk as the program will unpack the files
  143.               in the order you selected them, ignoring if the file
  144.               will overwrite old data.
  145.        
  146.        Repack: When you use repack you also must set the outfile. If
  147.               you select only one file that file will be repacked to
  148.               one file, but if you select one or more files, the files
  149.               will be unpacked to the repack device and then packed
  150.               so it will only be one file.
  151.        
  152.        Test:   If you use test all filenames are used.
  153.        
  154.        Text:   If you use text all filenames are used.
  155.        
  156.        View:   If you use view all filenames are used.
  157.  
  158.     Outfile
  159.        This works exactly the same as filename except this time you can
  160.        only select one file. Pressing the GET gadget to the right brings
  161.        up the filerequester. This filename is used when you repack a
  162.        file.
  163.     
  164.     Textfile
  165.        Same as outfile. This is the textfile that is to be included
  166.        when you pack a disk. The textfile is used when you pack disks
  167.        and when you repack more than one file into one file.
  168.        (PS. It's not used when you repack one file to outfile DS.)
  169.     
  170.     Password
  171.        If you type _ANY_ text in this gadget the file will be decrypted/
  172.        encrypted with this text as the password. Useful if you like to
  173.        protect your disks from unauthorized persons.
  174.     
  175.     Low track
  176.        This is actually two gadgets, one dragbar and one stringgadget.
  177.        This is used to select the starting track for the DMS program.
  178.        You can either use the dragbar to select the track number or
  179.        you can click in the stringgadget and type the tracknumber.
  180.        There is a small problem when you click in the stringgadget,
  181.        if you type anything and the screen flashes, try typing DEL or
  182.        BACKSPACE to erase the old number.
  183.     
  184.     High track
  185.        Exactly as low track, but this time you choose the ending track
  186.        for the DMS program.
  187.     
  188.     Crunch mode
  189.        Here you select which degree of crunching you would like to use.
  190.        In the old 1.03 version of DMS there were 5 degrees of crunchmode,
  191.        from NONE to DEEP, but in the new 1.11 version there is only
  192.        three modes, BEST, HEAVY1 and HEAVY2.
  193.     
  194.     Crunch device
  195.        This is which device that is to be used when you read/write files
  196.        that you want to unpack/pack.
  197.     
  198.     Repack device
  199.        This is which device that is to be used when you repack two or
  200.        more files into one file. You should use RAD: or any fast
  201.        device for this option.
  202.     
  203.     Load Paths
  204.        This brings up a requester which prompts you to choose a '.paths'
  205.        file to load into memory. If you have loaded a '.paths' file
  206.        already that file will be discarded.
  207.     
  208.     Load FList
  209.        This works like 'Load Paths' except now you choose a '.files'
  210.        file to load.
  211.     
  212.     Scan devs
  213.        This makes the DMSui program scan for any new devices that may
  214.        have been mounted since you started the program. At startup the
  215.        DMSui program will look for which devices you have and setup
  216.        Crunch/Repack device so they only show the DOS devices which
  217.        contains 80 tracks (880k). This option is useful if you, after
  218.        startup, mounts RAD: or any other device and would like that
  219.        device included in the device gadgets.
  220.     
  221.     Scan files
  222.        This brings up a requester which prompts you to select a file-
  223.        name of the new '.files' file that is to be created. After that
  224.        the program will scan the directorys for files and save them
  225.        on disk. If you haven't loaded a '.paths' file this will not
  226.        work because the '.paths' file is used to see which directorys
  227.        is to be scanned. All files are stored on disk, not only the
  228.        DMS or WRP files (This is to make the file compatible with
  229.        another of my programs, IceCopy, which uses all files). Only
  230.        the DMS and WRP files will be shown in the filerequester.
  231.     
  232.     Set Prefs
  233.        This brings up a window where you can set your preferences.
  234.        More on this in the preferences section.
  235.     
  236.     Load CList
  237.        This brings up a filerequester which prompts you to select a
  238.        '.clist' file to load. After that a window is opened and you
  239.        are shown which files that are not found in the requester.
  240.        (This may sound a little bit weird, but you see how it works)
  241.        This makes the program select all the files specified in the
  242.        '.clist' file in the requester. This option is only enabled
  243.        when you have selected 'Multipel disks' and only when you use
  244.        my filerequester.
  245.     
  246.     Read
  247.        Starts the DMS program and starts to pack a disk to a file.
  248.        See the DMS.doc file in the DMS package for more info.
  249.     
  250.     Write
  251.        This writes the selected files to the disk. The DMSui program
  252.        can unpack both .DMS and .WRP files (but then you need the
  253.        UnWarp program) so you don't need to bother which of the two
  254.        types the files is.
  255.        See the DMS.doc file in the DMS package for more info.
  256.        
  257.     Repack
  258.        This repacks the Filename/s into one files (outfile). If more
  259.        than one filename is selected the files are unpacked to the
  260.        repack device and then packed to the outfile.
  261.        See the DMS.doc file in the DMS package for more info.
  262.     
  263.     Test
  264.        This tests the selected files to see if they are intact.
  265.        See the DMS.doc file in the DMS package for more info.
  266.     
  267.     Text
  268.        This displays the texts included in the selected files.
  269.        See the DMS.doc file in the DMS package for more info.
  270.     
  271.     View
  272.        This displays information about the selected files.
  273.        See the DMS.doc file in the DMS package for more info.
  274.     
  275.     About
  276.        This brings up a window with info about the programmer (me)
  277.        and how to contact me. Click the mouse to close it.
  278.     
  279.     Multipel disks
  280.        This option is only used when you use my filerequester (see
  281.        the preferences section). This makes it possibel for you
  282.        to select a lot of files and then unpack them without having
  283.        to select the files between every disk. Before each file you
  284.        are prompted with this:
  285.        
  286.        Unpacking file:
  287.        Test.DMS (i.e)
  288.        Press RETURN to start, ESC to skip! CTRL-C or CTRL-D to abort!
  289.        
  290.        which makes it possible for you to skip a file or abort the
  291.        whole operation.
  292.  
  293.     Wait
  294.        This option enables the KEYS/MOUSE function in the preferences.
  295.        When the DMS has finished its job, you will be prompted with
  296.        either 'Press RIGHT mousebutton to continue!' or 'Press RETURN
  297.        to continue'. If you don't select this option the window will
  298.        close automatically.
  299.     
  300.  
  301.    Preferences
  302.        When you select 'Set Prefs' a window will appear where you can
  303.        set you preferences. I will now discribe the functions in that
  304.        window.
  305.        
  306.        There are a few lead texts above the gadgets. These are:
  307.     
  308.        DMS flags
  309.        DMSui flags
  310.        Window settings
  311.        Default setup
  312.        User paths
  313.        
  314.        First, under the DMS flags, you have five flags that you can
  315.        set for use with the DMS program. See the DMS.doc file for
  316.        more information about these.
  317.        
  318.        Secondly, under the DMSui flags, you have four flags that you
  319.        can set. These are Video mode, Input mode, Requester mode and
  320.        DMS version. Video mode means PAL or NTSC and resizes all
  321.        requesters to either 256 or 200 lines. The output window is
  322.        also changed to either 256 or 200 lines.
  323.        Input mode is used with the 'Wait' flag and you can switch
  324.        between MOUSE and KEYS.
  325.        Requester mode is used to select if you want to use the
  326.        req.library requester (DIRS) or my filerequester (REQS).
  327.        If you choose to use my filerequester the thing that will happen
  328.        is this: When you click on the GET gadget to the right of the
  329.        filename gadget you will get my filerequester instead of req
  330.        librarys requester.
  331.        DMS version is used to set which version of the DMS program
  332.        you use. This makes the Crunchmode change because in v1.03
  333.        there was five types of crunchmode and in v1.11 there is
  334.        only three.
  335.        
  336.        After that you have the window settings. This is used to set
  337.        the coordinates of the output window. The Y size changes when
  338.        you change Video mode.
  339.        
  340.        Then we have the Default setup. Here you can type which
  341.        '.paths' file is to be loaded on startup. If you don't specify
  342.        anything here, no file will be loaded. You can also select
  343.        which '.files' file is to be loaded.
  344.        In the 'Name' gadget you can specify the name of the DMS program.
  345.        This is useful if you have more than one version of the DMS
  346.        program installed and have another name on the other copy.
  347.        
  348.        At last there is the user paths. Here you specify which paths
  349.        that is to be searched when you start the DMS program.
  350.        Current directory and C: is _ALWAYS_ used, but if you put the
  351.        DMS program in the C1: directory you must type that path here.
  352.        You have ten different paths at your service and you can type them
  353.        in by clicking in the stringgadget and then use the arrows to
  354.        scroll in the list or you can press the GET gadget.
  355.        If you press the GET gadget a requester will appear, making it
  356.        possible for you to select up to ten different paths (it starts
  357.        counting from the path you have activated in the stringgadget)
  358.        by just selecting the desired directory and pressing 'Ok'. The
  359.        requester will reappear until you press cancel or closewindow.
  360.        When you are finished selecting paths you will be asked to set
  361.        the default directory for infiles (filename). Press 'Yes' if you
  362.        want to set it or 'No' if you don't. After that the same thing
  363.        is asked about outfiles and textfiles.
  364.        
  365.        When you are finished with the settings you can select OK, Save
  366.        Prefs or CANCEL. If you select OK the settings will be used. If
  367.        you select Save Prefs the settings will be saved to the file
  368.        'S:DMSui.prefs' and used. Pressing CANCEL terminates the settings
  369.        and uses the old settings.
  370.     
  371.     
  372.    Some hints and other stuff
  373.     To clear a stringgadget, just activate it and press AMIGA-X.
  374.     
  375.     If an error occure when starting the DMSui program from Workbench
  376.     the error will be displayed in the Workbench title bar, so just look
  377.     there if you don't get the program to work properly from Workbench.
  378.     If you put the DMSui program somewhere else than in the same
  379.     directory as the DMSui.info file, then you must tell the DMSui.info
  380.     file where to get the DMSui program from. This can be made from
  381.     either Workbench or CLI. From Workbench just activate the DMSui icon
  382.     and the go to the menu in Workbench where you find an option called
  383.     'Info' or 'Information'. Now you can enter the proper path and
  384.     filename in the stringgadget called COMMAND.
  385.     If you want to change this thing when using CLI then just start
  386.     IconEd or any other icon-editor and edit the COMMAND string.
  387.     
  388.     One final note, if the DMS program fails when you use the DMSui
  389.     program    then just type 'endcli [RETURN]' and the program will
  390.     continue.
  391.     
  392.     This was about all of the docs. Use this program as much as you
  393.     want and spread it around the world. If you have any suggestions
  394.     of how to improve this program or if you find any BUGS then just
  395.     leave a note to me (Ice) on:
  396.  
  397.     Guru's Dream
  398.     
  399.        Node 1:  +46-8-363425 (HST DS 16.8 kbps)
  400.        Node 2:  +46-8-368169 (2400 bps -> 16.8 kbps)
  401.        Node 3:  +46-8-369205 (HST 16.8 kbps)
  402.        Node 4:  +46-8-369225 (HST 16.8 kbps)
  403.     
  404.        Handle: Ice
  405.     
  406.     Nordiska PD
  407.     
  408.        Node 1:  +46-13-112196 (2400 bps)
  409.        Node 2:  +46-13-102710 (2400 bps)
  410.        Node 3:  +46-13-102711 (2400 bps)
  411.        Node 4:  +46-13-102712 (2400 bps -> HST 14.4 kbps)
  412.        Node 5:  +46-13-105690 (2400 bps)
  413.     
  414.        Handle: Mathias Axelsson
  415.  
  416.     Current line
  417.     
  418.        +46-11-143564
  419.     
  420.        Handle: Mathias Axelsson
  421.     
  422.    I will soon get a Fidonet address. Until I get that you can use
  423.    the number 2:204/458 (Current Line).
  424.    That was all the documentaion for this version of DMSui. I'll be back!
  425.  
  426.    Signed Ice August 3rd 1992.
  427.  
  428.    Contact me:    Mathias Axelsson
  429.            Skirtorpsvägen 18
  430.            S-641 35  KATRINEHOLM
  431.            SWEDEN
  432.            
  433.            +46-150-17877
  434.  
  435.    And please support me. If you don't pay the fee then give me disks or
  436.    whatever, anything is welcome. I would like to see how many users there
  437.    is so please send a postcard to me with a little greeting on it.
  438.